제스처 영역 위젯

경로: 위젯 갤러리> 버튼> 기타

제스쳐 영역 위젯은 제스쳐 이벤트를 생성하는 핫스팟 버튼입니다.

 

제스쳐 이벤트 설명

OnSwipeLeft

OnSwipeRight

옆으로 쓰는 제스쳐가 감지될 때 이벤트가 나타납니다

OnPinchOpen

OnPinchClose

꼬집는 제스쳐가 감지될 때 이벤트가 나타납니다.

RotateClockwise

RotateAntiClockwise

회전시키는 제스쳐가 감지될 때 이벤트가 나타납니다.

OnPan

OnPinch

OnRotate

제스처가 감지되는 동안 나타나는 이벤트들.

자바스크립트만 이러한 이벤트를 처리할 수 있고, 개발자는 자바스크립트 코드를 통해 제스쳐 이벤트를 선호하는 대로 관리할 수 있습니다.

경고: 멀티터치 입력이 가능한 HMI 장치에서만 OnPinch와 OnRotate 이벤트를 생성할 수 있습니다

OnPan

boolean onGesturePan(me, eventInfo)

이 이벤트는 영역 내의 한 지점이 눌려지고 선형으로 움직이는 것이 감지되었을 때 발생합니다.

파라미터 설명
me 이벤트를 작동시키는 객체
eventInfo

id = 제스쳐 아이디, 서로 다른 제스쳐를 식별하기 위해 사용됩니다.

running = 제스쳐가 완료되었다는 것을 알리기 위해 전달된 마지막 이벤트를 제외하고는 참(true).

dx = 초기에 터치한 위치에서 X축 방향으로 움직인 스크린 픽셀 단위의 총 거리.

dy = 초기에 터치한 위치에서 Y축 방향으로 움직인 스크린 픽셀 단위의 총 거리.

OnPinch

boolean onGesturePinch(me, eventInfo)

이 이벤트는 영역 내의 두 지점이 눌려지고 선형으로 움직이는 것이 감지되었을 때 발생합니다.

파라미터 설명
me 이벤트를 작동시키는 객체
eventInfo

id = 제스쳐 아이디, 서로 다른 제스쳐를 식별하기 위해 사용됩니다.

running = 제스쳐가 완료되었다는 것을 알리기 위해 전달된 마지막 이벤트를 제외하고는 참(true).

dx = 초기에 터치한 위치에서 X축 방향으로 움직인 스크린 픽셀 단위의 총 거리. 두 손가락 사이의 거리를 나타냅니다. 양의 값은 거리가 증가했음을 의미하고 음의 값은 거리가 감소했음을 의미합니다. 이 (증가/감소)량을 줌 값을 제어하기 위해 사용할 수 있습니다.

dy = X축 방향으로 움직인 스크린 픽셀 단위의 총 거리(dx를 참조하십시오).

OnRotate

boolean onGestureRotate(me, eventInfo)

이 이벤트는 영역 내의 두 지점이 눌려지고 회전하는 움직임이 감지되었을 때 발생합니다.

파라미터 설명
me 이벤트를 작동시키는 객체
eventInfo

id = 제스쳐 아이디, 서로 다른 제스쳐를 식별하기 위해 사용됩니다.

running = 제스쳐가 완료되었다는 것을 알리기 위해 전달된 마지막 이벤트를 제외하고는 참(true).

drot = 이전 이벤트 이후 추가된 각도(0/360).

trot = 전체 움직임 동안 추가된 총 각도(0/360).

양의 값은 시계 방향을 음의 방향은 반시계방향을 의미.

제스처 이벤트 패스스루

제스쳐 객체로 덮인 위젯(예: 버튼 또는 슬라이더)을 사용하려면, 200밀리초 동안 위젯을 눌러서 컨트롤을 아래에 깔린 객체로 이동시켜야 합니다. 아래에 깔린 객체에 명령을 보낼 때까지 기다려야 하는 시간은 고급 속성 보기에서 “제스쳐 패스 지연” 파라미터에서 수정할 수 있습니다.

파라미터 설명
제스처 패스스루 활성화

설정한 지연 시간 후에 제스체 이벤트를 아래에 깔린 객체에 전달할 수 있게 합니다. 손가락으로 계속 누른채로 제스쳐를 실행해야합니다.

default = 프로젝트 속성에서 정의한 값을 사용합니다. "프로젝트"를 참조하십시오.

true = 제스처 패스스루 활성화

false = 제스처 패스스루 비활성화

제스처 패스스루 지연 (ms)

아래에 깔린 객체에 명령을 전달하기 위해 반드시 기다려야할 시간

0/500 mSec
1 프로젝트 속성에서 정의한 지연을 사용합니다. "프로젝트"를 참조하십시오.
제스쳐 이벤트를 자바스크립트와 연계해서 사용하는 예

다음은 자바스크립트 코드와 연계해서 제스쳐 이벤트를 사용하여 제스쳐를 식별하고 요청된 액션을 프로그래밍하는 예제가 있습니다

스와이프 제스쳐

“스와이프” 제스쳐를 인식하고 애플리케이션에서 페이지를 변경하는 법.

  1. 제스쳐 영역 위젯을 페이지에 놓으십시오
  2. 자바스크립트 함수를 작동시키기 위해 OnPan 액션을 구성하십시오
  3. 스와이프 제스처를 인식하고 관리하는 자바스크립트 코드를 쓰십시오

핀치 제스쳐

이미지를 이동시키는 “팬” 제스쳐를 인식하는 법.

  1. 제스쳐 영역 위젯을 페이지의 이미지 위에 놓으십시오
  2. 자바스크립트 함수를 작동시키기 위해 OnPinch 액션을 구성하십시오
  3. 핀치 제스처를 인식하고 관리하는 자바스크립트 코드를 쓰십시오

팬 제스쳐

이미지를 이동시키는 “팬” 제스쳐를 인식하는 법.

  1. 제스쳐 영역 위젯을 페이지의 이미지 위에 놓으십시오
  2. 자바스크립트 함수를 작동시키기 위해 OnPan 액션을 구성하십시오
  3. 팬 제스처를 인식하고 관리하는 자바스크립트 코드를 쓰십시오